home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Internet Tools 1995 April / Internet Tools.iso / infoserv / www / cern / doc / www-talk.archive.Z / www-talk.archive / text0089.txt < prev    next >
Encoding:
Text File  |  1992-11-30  |  4.9 KB  |  113 lines
  1. Rama Porrat <rama@noa.huji.ac.il> writes,
  2.  
  3. > I am trying to write a help online manual using www. I think www can be very
  4. > useful and the stuff I deal with really needs such a system.
  5. > BUT there are things which must be corrected in order that www will be
  6. > usable, and I am writing in the hope that you can correct the www
  7. > or tell me if those things can be corrected soon.
  8.  
  9. > The most annoying thing is the appearance of a "listing" file
  10. > on screen when displayed by www.  The fact that pages
  11. > are displayed "backward", that is, you repeat portions of the
  12. > file alsready displayed when you come to the last page of a file,
  13. > is unacceptable. It makes a mess out of the display.
  14. > The way a listing file is displayed should adhere to what's in the
  15. > file, without any "going back". This is essential.
  16.  
  17. We haven't noticed this!  By "listing" file, do you mean a plain text
  18. file, or part of a marked-up file which uses the <listing> tag?
  19. What you describe seems very strange.  Please give me a reference to the file
  20. if it on a server, or else mail it to me. Thanks.
  21.  
  22. > The way the word [end] is displayed at the end of a screen is not nice.
  23. > It is too close to the last line and in the "middle" of the line.
  24. > The www writer should have the option not to display this [end]
  25. > at all, or otherwise put it in a lower and to the side of the
  26. > screen.
  27.  
  28. This is question of taste. It is easy to recompile the browser (just GridText.c)  
  29. with the option to define the macro END_MARK as "".  You can do that locally. The  
  30. [end] mark was put in to stop people trying to scroll past the end of the file,  
  31. having to press RETURN every time just to see whether there was any more left. It  
  32. would be simpler not to have it!
  33.  
  34. Note that the X11 browsers do not have an [end] mark. On VM/XA  and MVS systems
  35. it is <End>.  You could make a void (or Hebrew) version if you needed to.
  36. All these things are in the file GridText.c in the browser implementation.
  37. You could make a local variant.  If others on this list agree, then we could  
  38. incorporate certain options in the master source.
  39.  
  40. > The h1 header displays numbers which are confusing for the reader.
  41. > For example, in my listing file, the addition of <h1> displays the numbers (on
  42. > sequential pages)  no numbers on first page
  43. > (50/64) on next page (64/64) on last page.
  44. > This is quite confusing.
  45.  
  46. These numbers should not be connected with the <h1> header.  They are the line  
  47. number of the bottom line on the screen, and the line number of the last line in  
  48. the file. They were asked for by users, to give some indication of how far through  
  49. the document one is.  The numbers are not displayed on the first page as that
  50. is displayed before the whole file has been read, for speed.
  51.  
  52. >  You even get numbers like (69/64).
  53.  
  54. If you could scroll down so that blank space after the document were
  55. displayed, the bottom line would be greater than the last line.  But I can't get it  
  56. to happen. Could you give me the exact sequence you are using, please, along with  
  57. document addresses?  And tell me the version number you have (type help to get it).
  58.  
  59. > Please erase those numbers, or display something clear, like:
  60. > Page 1 out of 3          etc.
  61.  
  62. The file is not divided strictly into pages, so to displaying page numbers
  63. would be confusing. For example, when one returns to a document one has left by a  
  64. link, that link is displayed, if possible, a third of the way down the page. This  
  65. will not necessarily allign with a "page".
  66.  
  67. > The <title> is inconsistent - at times it appears on screen, 
  68.  
  69. > at other times it doesn't.
  70.  
  71.     Yes. This is a feature of the pipeline optimisation of
  72.     the code. When the document is started, its title is not
  73.     known and neihter is its length. The first characters are
  74.     displayed on the screen as soon as they come in. This
  75.     gives a faster response time
  76.  
  77. > There should be a possibility to enter the www with a pre-known
  78. > pointer.  For example, saying     www tex
  79. > should be able to give you the top screen pertaining to tex, without
  80. > going through a number of previous screens.
  81.  
  82.     There is.
  83.     You have to give the network address of the document, which is
  84.     not so simple. It would have to be something like
  85.  
  86.         www http://info/tex
  87.  
  88.     as "www tex" will cause www to read a file "tex" in the local directory.
  89.  
  90.     Note you can define alises for users
  91.     
  92.         alias texhelp www http://info/help/tex/html
  93.         texhelp
  94.  
  95.     for example
  96.  
  97. >It is also very important to give the possibility of including
  98. >comments in html sources.
  99.  
  100.     Yes. The <comment> junk </comment> tag is respected by
  101.     recent browsers, but only recent ones: Not the NeXT browser.
  102.  
  103. I hope this at least explains the raesons for a few things. I have put the  
  104. intermittency of the title on our list of bugs to be fixed. We may put in options
  105. to control some of the other things. If anyone else on this list has views on these  
  106. things, they should say. It is only from comments from real users what break away  
  107. from our own view of what if "nice" in a browser: Thanks for your feedback.
  108.  
  109.     Tim BL
  110.  
  111.  
  112.  
  113.